<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>os-release
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>os-release 中文手册</h1><h2 id="auth_name">译者：<strong><a href="../index.html">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="../index.html">金步国作品集</a> [ <a href="../index.html">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="os-release"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>os-release — 操作系统标识</p></div><div class="refsynopsisdiv"><h2>大纲</h2><p><code class="filename">/etc/os-release</code></p><p><code class="filename">/usr/lib/os-release</code></p></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="os-release.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p> <code class="filename">/etc/os-release</code> 与
    <code class="filename">/usr/lib/os-release</code> 文件包含了
    操作系统识别数据。</p><p><code class="filename">os-release</code>
    文件的基本格式是
    一系列换行符分隔的 VAR=VALUE 行(每行一个变量)，
    可以直接嵌入到 shell 脚本中使用。
    注意，此文件并不支持变量替换之类的任何高级 shell 特性，
    以便于应用程序无须支持这些高级 shell 特性，
    即可直接使用此文件。
    如果 VALUE 值中包含任何非字母数字字符(也就是 A–Z, a–z, 0–9 之外的字符)，
    那么必须使用引号(单双皆可)界定，
    并且任何在Shell中具有特殊含义的字符，
    包括：美元符, 单双引号, 反斜线, 反引号 ……
    等等，都必须使用shell风格的反斜线进行转义。
    所有字符串都必须使用UTF-8编码，
    并且禁止使用一切非打印字符。
    以"#"开头的行将被作为注释忽略。
    空白行也会被忽略。</p><p>应用程序应该只读取 <code class="filename">/etc/os-release</code> 文件，
    仅在
     <code class="filename">/etc/os-release</code>
    不存在的情况下，
    才可以读取 <code class="filename">/usr/lib/os-release</code> 文件。
    绝对禁止应用程序同时读取两个文件。
    操作系统发行商应该将操作系统识别数据存放在
     <code class="filename">/usr/lib/os-release</code> 文件中，
    同时将 <code class="filename">/etc/os-release</code> 作为一个软连接，
    以相对路径的方式指向
     <code class="filename">/usr/lib/os-release</code> 文件，
    以提供应用程序读取 <code class="filename">/etc</code> 的兼容性。
    软连接使用相对路径是为了避免在
    chroot 或 initrd 环境中失效。</p><p><code class="filename">os-release</code>
    的内容应当仅由发行版的供应商设置，
    系统管理员一般不应该修改此文件。</p><p>因为此文件仅用于操作系统识别，
    所以必须禁止包含任何需要本地化的内容(也就是禁止包含非ASCII字符)。</p><p> <code class="filename">/etc/os-release</code> 与
    <code class="filename">/usr/lib/os-release</code>
    可以是软连接，
    但是必须全部位于根文件系统上，
    以确保在系统刚启动时即可读取其内容。</p><p>更多有关 <code class="filename">os-release</code> 的理解，
    请参阅 <a class="ulink" href="http://0pointer.de/blog/projects/os-release" target="_top">Announcement of <code class="filename">/etc/os-release</code></a></p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="os-release.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>可以在
    <code class="filename">os-release</code> 中使用下列操作系统识别字段：</p><div class="variablelist"><dl class="variablelist"><dt id="NAME="><span class="term"><code class="varname">NAME=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#NAME=">¶</a></dt><dd><p>不带版本号且适合人类阅读的操作系统名称。
        这是必填字段。例如：
        "<code class="literal">NAME=Fedora</code>" 或 "<code class="literal">NAME="Debian
        GNU/Linux"</code>" 。
        默认值是
        "<code class="literal">NAME=Linux</code>" 。</p></dd><dt id="VERSION="><span class="term"><code class="varname">VERSION=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#VERSION=">¶</a></dt><dd><p>操作系统的版本号。
        禁止包含操作系统名称，但是可以包含适合人类阅读的发行代号。
        这是可选字段。
        例如：
        "<code class="literal">VERSION=17</code>" 或 "<code class="literal">VERSION="17 (Beefy
        Miracle)"</code>"</p></dd><dt id="ID="><span class="term"><code class="varname">ID=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#ID=">¶</a></dt><dd><p>小写字母表示的操作系统名称，
        禁止包含 0–9, a–z, ".", "_", "-" 以外的字符，禁止包含任何版本信息。
        该字段适合被程序或脚本解析，也可用于生成文件名。
        这是必填字段。例如：
        "<code class="literal">ID=fedora</code>" 或
        "<code class="literal">ID=debian</code>" 。
        默认值是
        "<code class="literal">ID=linux</code>" 。</p></dd><dt id="ID_LIKE="><span class="term"><code class="varname">ID_LIKE=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#ID_LIKE=">¶</a></dt><dd><p>一系列空格分隔的字符串，
        其中的每一项都符合 <code class="varname">ID=</code>
        字段的规范，
        也就是
        仅包含 0–9, a–z, ".", "_", "-" 字符。
        此字段用于表明当前的操作系统
        是从哪些"父发行版"派生而来，
        切勿列出从此发行版派生的"子发行版"，
        排列顺序由近到远，
        关系最近的发行版名称排在最前，
        紧密度依次递减。
        应用程序如果不能识别
         <code class="varname">ID=</code> 字段的内容，
        那么可以参考此字段。
        这是可选字段。
        比如对于 "<code class="literal">ID=centos</code>"来说，
        "<code class="literal">ID_LIKE="rhel fedora"</code>" 就是一个合理的设置。
        而对于 "<code class="literal">ID=ubuntu</code>" 来说，
        "<code class="literal">ID_LIKE=debian</code>"
        也很合理。</p></dd><dt id="VERSION_CODENAME="><span class="term"><code class="varname">VERSION_CODENAME=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#VERSION_CODENAME=">¶</a></dt><dd><p>
        小写字母表示的操作系统发行代号，禁止包含
        0–9, a–z, ".", "_", "-" 以外的字符，
        禁止包含任何版本信息以及操作系统名称。
        该字段适合被程序或脚本解析，
        也可用于生成文件名。
        这是可选字段，
        并且某些发行版可能不存在此字段。例如：
        "<code class="literal">VERSION_CODENAME=buster</code>",
        "<code class="literal">VERSION_CODENAME=xenial</code>"
        </p></dd><dt id="VERSION_ID="><span class="term"><code class="varname">VERSION_ID=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#VERSION_ID=">¶</a></dt><dd><p>小写字母表示的操作系统版本号，
        禁止包含 0–9, a–z, ".", "_", "-" 以外的字符，
        禁止包含操作系统名称与发行代号。
        该字段适合被程序或脚本解析，
        也可用于生成文件名。
        这是可选字段。例如： "<code class="literal">VERSION_ID=17</code>"
        或 "<code class="literal">VERSION_ID=11.04</code>"</p></dd><dt id="PRETTY_NAME="><span class="term"><code class="varname">PRETTY_NAME=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#PRETTY_NAME=">¶</a></dt><dd><p>适合人类阅读的比较恰当的发行版名称，
        可选的包含发行代号与系统版本之类的信息，内容比较随意。
        这是必填字段。默认值是
        "<code class="literal">PRETTY_NAME="Linux"</code>" 。
         例如：
        "<code class="literal">PRETTY_NAME="Fedora 17 (Beefy
        Miracle)"</code>" 。</p></dd><dt id="ANSI_COLOR="><span class="term"><code class="varname">ANSI_COLOR=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#ANSI_COLOR=">¶</a></dt><dd><p>在控制台上显示操作系统名称的
        文字颜色。
        必须设为符合 ESC [ m ANSI/ECMA-48 转义代码规范的字符串。
        这是可选字段。
        例如： "<code class="literal">ANSI_COLOR="0;31"</code>"(红色) 或
        "<code class="literal">ANSI_COLOR="1;34"</code>"
        (淡蓝)</p></dd><dt id="CPE_NAME="><span class="term"><code class="varname">CPE_NAME=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#CPE_NAME=">¶</a></dt><dd><p>操作系统的"CPE名称"(URI绑定语法)，
        详见
        <a class="ulink" href="http://scap.nist.gov/specifications/cpe/" target="_top">Common
        Platform Enumeration Specification</a> 文档。
        这是可选字段。例如：
        "<code class="literal">CPE_NAME="cpe:/o:fedoraproject:fedora:17"</code>"
        </p></dd><dt id="HOME_URL="><span class="term"><code class="varname">HOME_URL=</code>, </span><span class="term"><code class="varname">DOCUMENTATION_URL=</code>, </span><span class="term"><code class="varname">SUPPORT_URL=</code>, </span><span class="term"><code class="varname">BUG_REPORT_URL=</code>, </span><span class="term"><code class="varname">PRIVACY_POLICY_URL=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#HOME_URL=">¶</a></dt><dd><p>与操作系统相关的
        网址。
        <code class="varname">HOME_URL=</code>
        是操作系统的主页地址，
        或者特定于此版本操作系统的页面地址。
        <code class="varname">DOCUMENTATION_URL=</code>
        是操作系统的文档与手册地址。
        <code class="varname">SUPPORT_URL=</code>
        是操作系统的支持页面(若存在)，
        主要用于发行商提供技术支持的页面。
        <code class="varname">BUG_REPORT_URL=</code>
        是故障汇报页面(若存在)，
        主要用于基于社区互动的发行版。
        <code class="varname">PRIVACY_POLICY_URL=</code>
        是隐私条款页面(若存在)。
        上述URL应该分别出现在"About this system"界面下的
        "About this Operating System",
        "Obtain Support",
        "Report a Bug",
        "Privacy Policy"
        子界面中。
        这些字段的值必须符合
        <a class="ulink" href="https://tools.ietf.org/html/rfc3986" target="_top">RFC3986</a> 规范，
        通常以 "<code class="literal">http:</code>" 或
        "<code class="literal">https:</code>" 开头，
        但也可能以
         "<code class="literal">mailto:</code>" 或 "<code class="literal">tel:</code>" 开头。
        例如：
        "<code class="literal">HOME_URL="https://fedoraproject.org/"</code>" 与
        "<code class="literal">BUG_REPORT_URL="https://bugzilla.redhat.com/"</code>"</p></dd><dt id="BUILD_ID="><span class="term"><code class="varname">BUILD_ID=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#BUILD_ID=">¶</a></dt><dd><p>用于区分同一版本操作系统的
        不同编译次序的唯一标示符(不会被系统更新所修改)。
        该字段在不同的 VERSION_ID 之间有可能是相同的，
        因为 BUILD_ID 仅在同一版本号内部保持唯一。
        每当发布新版本的操作系统时，
        只需要更新 VERSION_ID 字段即可，并不一定必须更新 BUILD_ID 字段。
        这是可选字段。
        例如： "<code class="literal">BUILD_ID="2013-03-20.3"</code>"
        或 "<code class="literal">BUILD_ID=201303203</code>"

        </p></dd><dt id="VARIANT="><span class="term"><code class="varname">VARIANT=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#VARIANT=">¶</a></dt><dd><p>
        适合人类阅读的发行版分支标识符。
        用于向用户表明
        此系统的默认配置是
        专门面向特定应用场景的。
        这是可选字段，
        并且某些发行版可能不存在此字段。
        例如：
        "<code class="literal">VARIANT="Server Edition"</code>",
        "<code class="literal">VARIANT="Smart Refrigerator Edition"</code>"
        注意，此字段仅用于显示目的，
        程序应该使用 <code class="varname">VARIANT_ID</code>
        字段进行可靠的判断。
        </p></dd><dt id="VARIANT_ID="><span class="term"><code class="varname">VARIANT_ID=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#VARIANT_ID=">¶</a></dt><dd><p>
        小写字母表示的发行版分支标识符，禁止包含
        0–9, a–z, ".", "_", "-" 以外的字符。
        该字段适合被程序或脚本解析，
        也可用于生成文件名。
        这是可选字段，
        并且某些发行版可能不存在此字段。
        例如：
        "<code class="literal">VARIANT_ID=server</code>",
        "<code class="literal">VARIANT_ID=embedded</code>"
        </p></dd><dt id="LOGO="><span class="term"><code class="varname">LOGO=</code></span><a class="headerlink" title="Permalink to this term" href="os-release.html#LOGO=">¶</a></dt><dd><p>
        一个字符串，用于指定由 <a class="ulink" href="https://standards.freedesktop.org/icon-theme-spec/latest" target="_top">
        freedesktop.org Icon Theme Specification</a>
        规范的定义图标名称。
        图形界面程序可以根据此名称显示发行版图标。
        这是一个非必要的可选字段。
        例如：
        "<code class="literal">LOGO=fedora-logo</code>",
        "<code class="literal">LOGO=distributor-logo-opensuse</code>"
        </p></dd></dl></div><p>如果要在程序中检测发行版名称及其变种，
    那么可以使用
    <code class="varname">ID</code> 与 <code class="varname">VERSION_ID</code> 字段，
    并将 <code class="varname">ID_LIKE</code> 用作 <code class="varname">ID</code> 的替补。
    如果想要向用户显示发行版的名称，
    那么可以使用
    <code class="varname">PRETTY_NAME</code> 字段。</p><p>注意，
    滚动发布的发行版可能不会提供版本信息，
    也就程序不能假定 <code class="varname">VERSION</code> 与
    <code class="varname">VERSION_ID</code>
    字段必然存在。</p><p>操作系统的发行商可能为此文件引入新的字段，
    强烈建议为新引入的字段
    使用特别的前缀以避免冲突。
    读取此文件的程序应该能够安全的忽略不理解的字段。
    例如：
    "<code class="literal">DEBIAN_BTS="debbugs://bugs.debian.org/"</code>"</p></div><div class="refsect1"><a name="id-1.7"></a><h2 id="例子">例子<a class="headerlink" title="Permalink to this headline" href="os-release.html#%E4%BE%8B%E5%AD%90">¶</a></h2><pre class="programlisting">NAME=Fedora
VERSION="17 (Beefy Miracle)"
ID=fedora
VERSION_ID=17
PRETTY_NAME="Fedora 17 (Beefy Miracle)"
ANSI_COLOR="0;34"
CPE_NAME="cpe:/o:fedoraproject:fedora:17"
HOME_URL="https://fedoraproject.org/"
BUG_REPORT_URL="https://bugzilla.redhat.com/"</pre></div><div class="refsect1"><a name="id-1.8"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="os-release.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
        <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
        <a href="https://linux.die.net/man/1/lsb_release"><span class="citerefentry"><span class="refentrytitle">lsb_release</span>(1)</span></a>,
        <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a>,
        <a href="machine-id.html#"><span class="citerefentry"><span class="refentrytitle">machine-id</span>(5)</span></a>,
        <a href="machine-info.html#"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>
      </p></div></div></body></html>
